在 Angular 中实现搜索关键字高亮示例

2024-02-27 04:16:03 33

在Angular中，我们不应该试图直接修改DOM的内容，当需要更新DOM内容的时候，应该修改的其实是我们的数据模型，也就是$scope中的数据，Angular会帮助我们将修改之后的数据展示在页面中。

但是，在有些情况下，比如我们有一个搜索框，希望将搜索的关键字在正文中高亮出来，这时候就会感觉比较吃力了，filter可以帮助我们处理这种情况。

实际上，很多时候，我们的数据是不能直接输出到DOM中的，典型的比如日期，或者货币等等，通常需要将我们内部的数据格式化之后，再输出到页面中，在Angular中，这个工作就是通过filter来实现的。

filter是module级别的服务，定义之后，可以在整个module内直接使用，有着极高的复用性。

为了说明问题，先回顾一下的走进AngularJs(七)过滤器（filter）说明一下过滤器，然后详细说明如何处理搜索关键字高亮问题。你可以直接从自定义过滤器部分开始。

1.过滤器的用法

1.模板中使用

我们可以直接在{{}}中使用filter，跟在表达式后面用|分割，语法如下：

{{expression|filter}}

也可以多个filter连用，上一个filter的输出将作为下一个filter的输入。

{{expression|filter1|filter2|...}}

filter可以接收参数，参数用:进行分隔。

{{expression|filter:argument1:argument2:...}}

除了对{{}}中的数据进行格式化，我们还可以在指令中使用filter，例如先对数组array进行过滤处理，然后再循环输出：

2.在controller和service中使用

我们的js代码中也可以使用过滤器，方式就是我们熟悉的依赖注入，例如我要在controller中使用currency过滤器，只需将它注入到该controller中即可。

app.controller('testC',function($scope,currencyFilter){
$scope.num=currencyFilter(123534);
}

在模板中使用{{num}}就可以直接输出$123,534.00了！在服务中使用filter也是同样的道理。

此时你可能会有疑惑，如果我要在controller中使用多个filter，难道要一个一个注入吗，这岂不太费劲了？小兄弟莫着急~ng提供了一个$filter服务可以来调用所需的filter，你只需注入一个$filter就够了，使用方法如下：

app.controller('testC',function($scope,$filter){
$scope.num=$filter('currency')(123534);
$scope.date=$filter('date')(newDate());
}

2.内置的filter

1.currentcy,使用currency可以将数字格式化为货币，默认是美元符号，你可以自己传入所需的符号

{{num|currency:'￥'}}

2.date,原生的js对日期的格式化能力有限，ng提供的date过滤器基本可以满足一般的格式化要求。

{{date|date:'yyyy-MM-ddhh:mm:ssEEEE'}}

3.filter,注意了，这个过滤器的名字叫filter，不要搞混了。用来处理一个数组，然后可以过滤出含有某个子串的元素，作为一个子数组来返回。可以是字符串数组，也可以是对象数组。如果是对象数组，可以匹配属性的值。它接收一个参数，用来定义子串的匹配规则。

$scope.childrenArray=[
{name:'kimi',age:3},
{name:'cindy',age:4},
{name:'anglar',age:4},
{name:'shitou',age:6},
{name:'tiantian',age:5}
];

自定义的辅助函数。

$scope.func=function(e){returne.age>4;}

使用filter过滤器

{{childrenArray|filter:'a'}}//匹配属性值中含有a的
{{childrenArray|filter:4}}//匹配属性值中含有4的
{{childrenArray|filter:{name:'i'}}}//参数是对象，匹配name属性中含有i的
{{childrenArray|filter:func}}//参数是函数，指定返回age>4的

4.json,格式化json对象。json过滤器可以把一个js对象格式化为json字符串。作用就和我们熟悉的JSON.stringify()一样。

{{jsonTest|json}}

5.limitTo,limitTo过滤器用来截取数组或字符串，接收一个参数用来指定截取的长度。只能从数组或字符串的开头进行截取

{{childrenArray|limitTo:2}}//将会显示数组中的前两项

6.lowercase,转换为小写。把数据转化为全部小写。

7.uppercase,转换为大写。

8.number,格式化数字。number过滤器可以为一个数字加上千位分割，像这样，123,456,789。同时接收一个参数，可以指定小float类型保留几位小数：

{{num|number:2}}

9.orderBy排序，orderBy过滤器可以将一个数组中的元素进行排序，接收一个参数来指定排序规则，参数可以是一个字符串，表示以该属性名称进行排序。可以是一个函数，定义排序属性。还可以是一个数组，表示依次按数组中的属性值进行排序（若按第一项比较的值相等，再按第二项比较），

{{childrenArray|orderBy:'age'}}//按age属性值进行排序
{{childrenArray|orderBy:orderFunc}}//按照函数的返回值进行排序
{{childrenArray|orderBy:['age','name']}}
//如果age相同，按照name进行排序

3.自定义filter

我们先定义个没有参数的过滤器。第一个例子来自Angular官方的文档。

我们希望检查数据是否为真，如果为真的话，显示为一个✓，否则的话，显示为 ✘，在Unicode中，\u2713->✓，\u2718->✘，所以，我们需要做的就是检查数据是否为真，然后转化为这两个特殊字符进行输出。

app.filter('checkmark',function(){
returnfunction(input){
returninput?'\u2713':'\u2718';
};
});

过滤器还可以有参数，比如内置的过滤器可以格式话货币或者日期。

在过滤器后面，使用冒号(:)分隔的就是过滤器的参数，在过滤器中，可以获取这个参数，如果有多个参数，就继续使用冒号(:)进行分隔，所以，过滤器可以有多个参数。

下面实现一个截断超长字符串的过滤器。

app.filter("truncate",function(){
returnfunction(text,length){
if(text){
varellipsis=text.length>length?"...":"";
returntext.slice(0,length)+ellipsis;
};
returntext;
}
});

4.定义高亮filter

我们希望搜索的关键字在正文中高亮出来，正文就是过滤器的第一个参数，第二个参数就是搜索关键字，这样，我们的过滤器将会有两个参数了。

高亮的原理很简单，将需要高亮的内容使用span标记隔离出来，再加上一个特殊的class进行描述就可以了。

app.filter("highlight",function($sce,$log){

varfn=function(text,search){
$log.info("text:"+text);
$log.info("search:"+search);

if(!search){
return$sce.trustAsHtml(text);
}
text=encodeURI(text);
search=encodeURI(search);

varregex=newRegExp(search,'gi')
varresult=text.replace(regex,'$&');
result=decodeURI(result);
$log.info("result:"+result);
return$sce.trustAsHtml(result);
};

returnfn;
});

$sce,和$log是angular提供的两个服务，其中$sce服务需要使用 ngSanitize模块。关于这个模块，可以参考：angular-ngSanitize模块-$sanitize服务详解

5.定义服务对象

我们的页面可能很复杂，需要在一个控制器中输入关键字，但是，需要在多个控制器中使用这个关键字进行过滤，怎么处理呢？使用服务可以解决这个问题。

在Angular中，服务就是一个单例对象，我们使用factory可以直接定义一个服务对象。

app.factory("notifyService",function(){
vartarget={
search:"key"
};

returntarget;
});

在需要使用这个对象的地方，直接注入就可以获取这个对象了。

6.定义搜索Controller

在搜索控制器中，我们希望用户提供搜索关键字。为了方便检查，我们顺便将用户的输入展示出来。






{{notify.search}}

控制器的实现，我们将服务对象直接注入到控制器中，然后绑定到当前的$scope上，以便在当前控制器中实现绑定。

app.controller("tools",function($scope,notifyService){
$scope.notify=notifyService;
});

现在，我们可以直接输入搜索关键字，这个关键字将被保存到服务对象中，可以在当前的module中的各个控制器中访问这个服务对象。

7.在内容Controller中使用filter

现在，我们已经有了过滤器，也可以直接通过服务对象来获取搜索关键字，现在组合起来就可以使用了。text中是我们的正文内容。

为了在当前控制器中使用搜索关键字，关键是在搜索关键字发生变化的时候，还需要自动更新，我们将服务对象绑定到当前的$scope中，这是引用的名称为notify.

这样，在复杂页面中，我们可能存在多个控制器，在每个需要高亮的控制器中，我们只需要注入服务对象，就可以直接获取到当前的搜索关键字，配合使用过滤器，就可以直接实现全局高亮了。

结合过滤器和服务对象，我们实现了在复杂页面中，对整个页面中的内容进行关键字高亮。以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。

在 Angular 中实现搜索关键字高亮示例

热门推荐

随机推荐