useArrayJoin

类别

数组

导出大小

160 B

最后更改

5 天前

响应式的 Array.join

用法

与多个 refs 数组一起使用

import { useArrayJoin } from '@vueuse/core'

const item1 = ref('foo')
const item2 = ref(0)
const item3 = ref({ prop: 'val' })
const list = [item1, item2, item3]
const result = useArrayJoin(list)
// result.value: foo,0,[object Object]
item1.value = 'bar'
// result.value: bar,0,[object Object]

与响应式数组一起使用

import { useArrayJoin } from '@vueuse/core'

const list = ref(['string', 0, { prop: 'val' }, false, [1], [[2]], null, undefined, []])
const result = useArrayJoin(list)
// result.value: string,0,[object Object],false,1,2,,,
list.value.push(true)
// result.value: string,0,[object Object],false,1,2,,,,true
list.value = [null, 'string', undefined]
// result.value: ,string,

与响应式分隔符一起使用

import { useArrayJoin } from '@vueuse/core'

const list = ref(['string', 0, { prop: 'val' }])
const separator = ref()
const result = useArrayJoin(list, separator)
// result.value: string,0,[object Object]
separator.value = ''
// result.value: string0[object Object]
separator.value = '--'
// result.value: string--0--[object Object]

类型声明

/**
 * Reactive `Array.join`
 *
 * @see https://vueuse.vuejs.ac.cn/useArrayJoin
 * @param list - the array was called upon.
 * @param separator - a string to separate each pair of adjacent elements of the array. If omitted, the array elements are separated with a comma (",").
 *
 * @returns a string with all array elements joined. If arr.length is 0, the empty string is returned.
 */
export declare function useArrayJoin(
  list: MaybeRefOrGetter<MaybeRefOrGetter<any>[]>,
  separator?: MaybeRefOrGetter<string>,
): ComputedRef<string>

源码

源码 • 文档

贡献者

Anthony Fu

Anthony Fu

Levi (Nguyễn Lương Huy)

IlyaL

Levi (Nguyễn Lương Huy)

更新日志

v12.8.0 于 2025/3/5

7432f - feat(types): 弃用 MaybeRef 和 MaybeRefOrGetter，赞成 Vue 的原生方法 (#4636)

v12.3.0 于 2025/1/2

59f75 - feat(toValue): 弃用 @vueuse/shared 中的 toValue，赞成 Vue 的原生方法

v12.0.0-beta.1 于 2024/11/21

0a9ed - feat!: 移除 Vue 2 支持，优化捆绑包并清理代码 (#4349)

v10.0.0-beta.4 于 2023/4/13

4d757 - feat(types)!: 将 MaybeComputedRef 重命名为 MaybeRefOrGetter

0a72b - feat(toValue): 将 resolveUnref 重命名为 toValue