getStore(options)

获取共享存储的状态值，在使用时与 getState(options) API 的用法一致，但不同的是当前 getStore(options) API 具备本地存储中同步获取功能。 也就是说在存储全局变量状态值时同时也进行了本地同步存储，在下次打开应用获取时也同样存在。

options

参数名称	类型	必填	可选值	默认值	描述
key	string	是	-	-	获取共享状态值的键（key）值，在 setState 设置时的键（key）
path	string	否	-	-	数据对象路径

基础使用

<template>
	<view>
		<!-- 显示：测试值 -->
		{{ucsShare.getStore("test")}}
	</view>
</template>

<script setup>
	import ucsShare from "@/uni_modules/ucs-share"; 
	/**
	 * 示例设置共享状态键值
	 */
	ucsShare.setStore("test","测试值"); 
</script>

path参数使用

path 参数是在取 object 数据类型时取某单个对象时需要用到的参数

基础使用

<template>
	<view>
		<!-- 显示：参数1 -->
		{{ucsShare.getStore("test","param1")}}
	</view>
</template>

<script setup>
	import ucsShare from "@/uni_modules/ucs-share"; 
	/**
	 * 示例设置共享状态键值
	 */
	const data = {
		param1: "参数1"
	};

	ucsShare.setStore("test", data);
</script>

多层数据使用

当 object 数据存在多级时，可以使用 . 的方式进行下一层数据的选择

<template>
	<view>
		<!-- 显示：参数3 -->
		{{ucsShare.getStore("test","param2.param3")}}
	</view>
</template>

<script setup>
	import ucsShare from "@/uni_modules/ucs-share"; 
	/**
	 * 示例设置共享状态键值
	 */
	const data = {
		param1: "参数1",
		param2: {
			param3: "参数3"
		}
	};

	ucsShare.setStore("test", data);
</script>

数组数据使用

当 object 数据中存在数组需要取数组中的某一下标的值时，可以使用 .[0] 的方式，其中 0 指的是数组内的下标

<template>
	<view>
		<!-- 显示：参数3 -->
		{{ucsShare.getStore("test","param2.[1]")}}
	</view>
</template>

<script setup>
	import ucsShare from "@/uni_modules/ucs-share"; 
	/**
	 * 示例设置共享状态键值
	 */
	const data = {
		param1: "参数1",
		param2: ["参数2","参数3","参数4"]
	};

	ucsShare.setStore("test", data);
</script>