如何利用Xamarin Essentials存储的JWT声明动态控制Xamarin Forms的UI显隐

1. 封装Xamarin Essentials声明读取方法 #

你可以根据自己实际存储的位置（SecureStorage存敏感数据/Preferences存普通数据），封装统一的声明读取工具类：

public static class JwtClaimHelper
{
    // 读取指定声明的值
    public static async Task<string> GetClaimAsync(string claimKey)
    {
        // 如果用Preferences存储，替换为 Preferences.Get(claimKey, string.Empty)
        return await SecureStorage.GetAsync(claimKey);
    }

    // 快捷判断方法示例：判断是否有权限显示组件X
    public static async Task<bool> CanShowComponentX()
    {
        var claimVal = await GetClaimAsync("AccessComponentX");
        return bool.TryParse(claimVal, out bool res) && res;
    }
}

2. 实现值转换器（按需选择） #

如果需要根据声明的字符串值（比如角色、权限编码）直接判断显隐，可以自定义转换器，不需要单独在ViewModel里写大量判断逻辑：

public class ClaimToVisibilityConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        if (value == null || parameter == null) return false;
        // 声明实际值和要求值匹配就显示组件
        return value.ToString() == parameter.ToString();
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        throw new NotImplementedException();
    }
}

3. ViewModel添加权限绑定属性 #

在页面对应的ViewModel中添加控制显隐的布尔属性，页面初始化时读取XE存储的声明给属性赋值，记得实现INotifyPropertyChanged接口实现数据变更通知：

public class YourPageViewModel : INotifyPropertyChanged
{
    private bool _showComponentX;
    // 控制组件X显隐的绑定属性
    public bool ShowComponentX
    {
        get => _showComponentX;
        set 
        { 
            _showComponentX = value;
            OnPropertyChanged();
        }
    }

    // 页面加载时调用该方法加载权限配置
    public async Task InitPermission()
    {
        ShowComponentX = await JwtClaimHelper.CanShowComponentX();
        // 其他权限控制属性同理赋值
    }

    public event PropertyChangedEventHandler PropertyChanged;
    protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

4. XAML绑定IsVisible属性 #

首先在页面资源中注册转换器，然后给需要控制显隐的组件绑定对应的ViewModel属性即可：

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:converters="clr-namespace:你的应用命名空间.Converters"
             x:Class="你的应用命名空间.YourPage">
    <ContentPage.Resources>
        <ResourceDictionary>
            <!-- 注册转换器 -->
            <converters:ClaimToVisibilityConverter x:Key="ClaimToVis" />
        </ResourceDictionary>
    </ContentPage.Resources>

    <StackLayout>
        <!-- 通用组件始终显示 -->
        <Label Text="组件A" />
        <Label Text="组件B" />
        <Label Text="组件C" />
        <Label Text="组件D" />

        <!-- 仅满足权限条件时显示的组件X -->
        <Label Text="组件X" IsVisible="{Binding ShowComponentX}" />
    </StackLayout>
</ContentPage>

如果用转换器直接绑定角色类的声明，也可以这么写：

<!-- 仅角色为Admin的用户可见的组件 -->
<Button Text="管理员操作按钮" 
        IsVisible="{Binding UserRole, Converter={StaticResource ClaimToVis}, ConverterParameter='Admin'}" />

注意：前端显隐控制只是交互优化，敏感操作的后端接口必须同步做权限校验，避免前端被篡改后越权访问。

内容的提问来源于stack exchange，提问作者Asuka Cat